Skip to content

doc: documenter l'archivage fiable d'un projet - #128

Merged
shikanime merged 3 commits into
mainfrom
docs/sync-2026-10-19
Oct 27, 2026
Merged

shikanime merged 3 commits into
mainfrom
docs/sync-2026-10-19

Conversation

@shikanime

Copy link
Copy Markdown
Member

Quoi

Nouvelle section « Archivage d'un projet » dans Administration > Projets : ordre des opérations (verrouillage, nettoyage des ressources externes, archivage), comportement en cas d'échec (statut échoué, erreur 422, suppression rejouable), conflit de modification (409), et déverrouillage par un administrateur.

Pourquoi

La console a fiabilisé la suppression concurrente des projets (verrouillage du projet pendant la suppression externe, rejet de l'archivage d'un snapshot obsolète, nettoyage externe piloté avant l'archivage). Le comportement observable par les utilisateurs et administrateurs méritait d'être documenté.

Références

Co-authored-by: Automata <automata@shikanime.studio>

@StephaneTrebel StephaneTrebel left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

L’ordre verrouillage → nettoyage externe → archivage, les statuts et les erreurs 422/409 correspondent au code Console actuel, mais l’idempotence de tous les nettoyages est affirmée à tort : le cas contraire reste documenté dans Console #2785 et présent dans le chemin project.delete, comme détaillé inline. Les liens locaux, la structure Markdown et Test app build sont valides ; aucune suite applicative locale n’a été exécutée pour ce diff documentaire. Le suivi #119 couvre également la clarification suppression/archivage et la demande répétée sur un projet déjà archivé ; cette MR en couvre une partie, sans solder son ledger.

Comment thread docs/administration/projets.md Outdated
@shikanime shikanime added the documentation Improvements or additions to documentation label Oct 26, 2026
@shikanime shikanime self-assigned this Oct 26, 2026
Co-authored-by: Automata <automata@shikanime.studio>
StephaneTrebel
StephaneTrebel previously approved these changes Oct 27, 2026

@StephaneTrebel StephaneTrebel left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

La garantie générale d’idempotence signalée dans ma précédente revue a bien été retirée ; ce constat est corrigé. Les deux nouvelles suggestions, non bloquantes, visent à rendre la reprise après échec et le résultat de l’archivage compréhensibles ; liens locaux vérifiés et CI « Test app build » verte, sans build local ni recette de suppression, et le périmètre plus large de #119 reste ouvert.

Comment thread docs/administration/projets.md
Comment thread docs/administration/projets.md
Co-authored-by: Automata <automata@shikanime.studio>

@StephaneTrebel StephaneTrebel left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Les deux suggestions de lisibilité sont prises en compte : les étapes après échec sont explicites et liées aux journaux, et l’archivage est distingué d’une sauvegarde restaurable. Aucun nouveau constat ; trois liens locaux et la structure Markdown vérifiés, CI « Test app build » verte, sans build local ni recette de suppression exécutés (le suivi plus large #119 reste ouvert, aucun ledger modifié).

@shikanime
shikanime merged commit 99e136e into main Oct 27, 2026
1 check passed
@shikanime
shikanime deleted the docs/sync-2026-10-19 branch October 27, 2026 16:16
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants